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T aserS ent ^ pf0dUced with an Atari Me 9 a 4 co mputer using Microsoft Write 


and an Atari SLM804 




iNimsphctncATiON ti .o 3o - 1,090 ) 

1.0 AVAILABLE SERVICES 

1.1 The following Services are availabie in all release versions of the ROMS (release 
versions are 1.030, 1.040, 1.052, 1.07x, 1.09x, where x determines the language). 

SERVICE FUNCTION 

Get version number (of ROMs) 

Line Editor 

Get current application 
Reserved for custom add-ins 


08h Screen Save/Restore 

09h Draw Box 


00h 

01h 

02h 

03h 


OFh Menu Handling 

10h Box Area Calculation 


12h Message Windows 

14h Error Windows 


2.0 DETAILED DESCRIPTION OF SERVICES 


2.1 GENERAL 

2.1.1 Where co-ordinates are specified in 16 bit registers (eg. top right, bottom left) the 
upper byte is the y co-ordinate, and the lower byte is the x co-ordinate. 

2.1.2 For all box drawing routines (including menus, help, etc,), if the box is iarqer than 
the physical screen size, characters will be displayed incorrectly. 


2.2 Fn 00h Get version number 


Parameters: 

None. 

Returns: 

DS:DX 


Version number (zero terminated string) 
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2.3 Fn 01h Line Editor 


Parameters: 

DS:SI Pointer to editor control structure 

Returns: 

AX The character which caused termination 

Description 

Edits the line of text. The text can be in a box (or not), and text can be longer than 
screen width. Scroll margins exist at either end of the edit window. The controi 
structure is as follows:- 


ep_targ 

dw 

? 

far ptr to string to be edited. Result 


dw 

? 

edit is also pfaced here. All strings 
zero terminated. 

ep_pos 

dw 

? 

initial Position, in bytes, into the 
text on entry (starting at zero). 

ep„max 

dw 

? 

max length of edited string. 

ep_xpos 

db 

? 

screen xpos (starting at 0) 

ep_ypos 

db 

? 

screen ypos (starting at 0) 

ep_mode 

db 

? 

; When set to 2 the string will be cleared 
as editing starts (eg, files load); !f 
set to 0, the string is not cleared 
(eg. editing a worksheet cell) 

ep_hit 

dw 

? 

Initial keypress to be processed before 
getting keypress form user. Typically 
used for preprocessing characters. 

ep_tit 

dw 

? 

box title and prompt in the form 

ep_exit 

dw 

? 

db TITLE’,O/PROMPT’,0,0. 

dw 

? 

array of keycodes (see below) that allow 

ep_fn 

dw 

? 

exit from the editor. 

dw 

? 

address of the getkey routine. Routine 

ep_wid 

dw 

? 

should return a 16 bit keycode in AX 

db 

? 

Maximum box or screen width 

ep_wind 

db 

? 

Set to OFFh for no box, 0 for a single 
line box. 1 for a double line box. 

ep_res 

dw 

dw 

? 

7 

Reserved 

ep_udel 

dw 

7 

address of the undelete routine. This 


dw 

? 

routine is called every time a character 
is deleted. If not needed, use a dummy 
routine (ret far). DS:BX points to the 
deleted text. AH is 0 for the left delete 
and 1 for the right delete. Avoid changing 
segment registers. 
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Notes: 

1. The target buffer shouid be at least ’max'+l bytes long to accomodate the zero 

terminator. ’ ~ 

2 . If a default string is required. put it in the target buffer, zero terminated 

3. The array of exit keys consists of 16 bit ’keys’. The top nibble is zero for the 
Standard 256 characters, but for control characters like home, end.etc., it is set to 

(^ Y 9P DES: Normal ASCII characters represented as AL=ASCII code, AH=Ü eg 
A is 0041h. Extended keycodes represented as AL=scan code,AH=1, eg, left 
arrow-0148h. Special (DIP specific) keycodes represented as ÄL=code, AL-2/3 
^7, efore , sendin 9 undeleted characters (always inserted, no ‘ processinq) send 
0201h, and send 0202h at end of undelete characters. 

5, If you specify a box, then 2 bytes is taken away from ’wid’ when editing. 

6. Similarly, if you give a prompt, this will reduce your play area as well. 

2.4 Fn 02h Get current application 

Parameters: 

DL 
Returns: 

AL 

where: 

AL=0 
1 

2 

3 

4 

5 

6 
7 

Descriotion 

Determines the current application. This would typically be done from an editor hook 
or TSR. 

2.5 Fn 03h Reserved for custom add-ins 

Please contact Atari directly 


Set to FFh (-1) 
Current application 


Not in application 

Worksheet 

Diary 

Editor 

Address Book 

Calculator 

Setup 

Applications menu 
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2.6 Fn 08h Screen Save/Restore 


Parameters 

AL 

BH 

DS:SI 

CX 

DX 

Returns: 

None. 


Sub-service (0-3) 

Video page number 

Buffer to störe saved screen RAM 

Bottom right of screen area to save (inclusive) 

Top left of screen area to save (inclusive) 


Description 

bSfVr U p n 0 C inted e to h bv ns^si h* the SCreen arf ) a defined by Cx and Dx to ‘he 

ouner poimea to by DS.SI. The sub-service are as follows:- 


00 Save characters only 
01 Save characters + attributes 
02 Restore characters only 
03 Restore characters + attributes 


2.7 Fn 09h Draw Box 


Parameters: 

AL 

BH 

CX 

DX 

Returns: 

None. 


Type (0=single Jine, 1=double line) 
Video page number 
Bottom right of box 
Top left of box 


Description 

This function draws a box at the specified location on the screen 

2.8 Fn OFh Menus 


Parameters: 


AL 

AL 

BH 

CH 

CL 

DX 

DS.SI 

ES:D! 

(if Dl is FFFFh th 


Type (0=single line, 1=double line) 

Bits 3..7 max depth of menu (including borders) 

Video page number 

Last top line 

Last selected item 

Top left of box 

Menu text (double terminated zero) 

Defaults text (double terminated zero) 
ere is no defauit text) 


Returns: 

AX 

OR 

AH 

AL 


-1 for ESC pressed 

Top line 
selected line 
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Description 

Draws a menu at the location specified in DX. CH specifies the line that will appear 
at the top of the screen, and CL specifies the line that the Cursor will be on (with 
respect to the menu text, not including the title). The first line of the menu text is the 
menu title and does not have a corresponding entry in the defaults text. If no title is 
required this can be set to zero (null string). If bits 3..7 of AL are 0 then the menu 
will not have depth checking. If a single line box is selected, the function will draw an 
empty box (with the title) and return, Otherwise the menu will be displayed, and 
once a selection has been made, the menu box becomes single line and control 
returns to the caller. 

2.9 Fn 10h Box Area Calculation 


Parameters: 
DX 
DS:SI 
ES :DI 


Top left of box 

Menu text (double terminated zero) 
Defaults text (double terminated zero) 


Returns: 

AH 

AL 

BX 

CX 


Number of items (including title) 

Number of items (including title) 

Number of bytes used (excluding attributes) 
Bottom right of box 


Description 

Calculates the number of bytes needed to save the screen for a given menu. Note 
that the maximum width is assumed to be the maximum menu item + the maximum 
default. Also DX is destroyed by this call. 


2.10 Fn 12h Message Windows 


Parameters: 

BH 

DX 

DS:SI 

Returns: 

None. 


Video page number 
Top left of box 

Message text (double terminated zero) 


Description 

Displays text at DS:SI on the screen in a double line box. First line of text is taken 
as the title. This Service is used for the information messages, such as Loading, 
saving, etc. 
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2.10 Fn 14h Error Windows 


Parameters: 

BH 

DX 

CX 

DS:SI 


Video pagenumber: 

Top left of box 

Must be set to non-zero value 
Error text (double terminated zero) 


Returns: 

None. 


Description 

i?eSd te a X nH a !h D p S | 1 fn ? n 1he S 4 Cr ? en 3 d0Uble Nne box - There is no title. A beep 
is emitted and the function waits for a key to be pressed. The screen is then P 

restored and then control is returned to the caller. 
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